home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / MINT / PPPKIT14.ZIP / PPP_KIT1.3 / PPPKIT.ENG < prev    next >
Encoding:
Text File  |  1996-10-08  |  16.0 KB  |  430 lines

  1. PPP Internet Connection Kit for MiNT
  2.  
  3. Abel PHILIPPE
  4. October, 8th, 1996
  5.  
  6. Version 1.4
  7.  
  8. Description
  9. ----------------
  10.  
  11. Here is a (near) ready-to-use kit to connect yourself to Internet with 
  12. the PPP (Point to Point Protocol), and so access the WWW. It works under 
  13. MiNT. Hey, stay here ! It is not necessary to have a Minix partition at 
  14. all... This kit needs FreeMint 1.12.5, Mint OS 1.4.1, MintNet 1.0 pl1, 
  15. the Cab_for_MintNet 1.77 overlay, HS Modem 07, pppd 2.2.0, and of course 
  16. Cab 1.41.
  17.  
  18. The use of Mint is totally transparent : no Unix command to learn ! After 
  19. more than one month of unrewarded tries, and lots of spent nights (yeah, 
  20. I know, I'm not very fast !), I finally made it, I succeed to connect to 
  21. my provider. I must say that informations was very straggling, and I 
  22. didn't know (nearly) anything to Mint, nor Internet (specially PPP 
  23. connections).
  24.  
  25. At this time, I succeded connections to two french providers (Compuserve 
  26. and Imaginet). I don't know if it will work with others. In case of 
  27. matters, don't hesitate to contact me.
  28.  
  29. This connection strategy work fair well, very well, in fact. 
  30. Nevertheless, it couldn't be considered (in my opinion) as a definitive 
  31. solution. It is heavy to setup (now it is !), it needs place in RAM and 
  32. HardDisk. As a Bulldozer for a sand castle (all of this to obtain a PPP 
  33. connection...). I look forward a new STiK version. In the over way, the 
  34. use of Mint open the way of all Unix applications for a minus coding 
  35. effort.
  36.  
  37. I installed this kit on a TOS 4.02 Falcon030 with 4MB of RAM. I can't 
  38. help you for the other kinds of Atari.
  39.  
  40. Configuration
  41. -------------
  42. I imagine that 2 Mo are necessary for this kit. If you succeed, tell it 
  43. to me !
  44.  
  45. You will need 350 Ko on the boot disk, 1.3 Mo for the MINTNET folder (see 
  46. below), 900 Ko for Cab, and a few Mo if possible for the Cab cache.
  47.  
  48. As usual, the use of boot driver (as Xboot 3.0 & cie) is highly 
  49. recommended !
  50.  
  51. Essential Stuff
  52. ---------------
  53.  
  54. In add of this kit, you'll need these softwares :
  55. HS Modem 07        Cab 1.41
  56.  
  57. You can find these files at the ftp of the CNAM, in France, for example.
  58.  
  59. At the end, you'd better find and install these tools :
  60. C_ed 0.3 (Cab cache driver)
  61. ApexViewers 4.1 (fast GIF, JPEG, TGA and FLI viewers)
  62.  
  63. Internet Access Providers
  64. -------------------------
  65. You have to choose a provider who offer a PPP connection with dynamic IP 
  66. number allocation (this number identifies your computer in the Net). I 
  67. think all providers offer that.
  68.  
  69. Once you've suscribed, ask your providers small CAPITAL infos : 
  70.  
  71. - his modem phone number
  72.  
  73. - the connection parameters : speed, parity (even or none), number of bit 
  74. (7 or 8), control protocol (RTS/CTS, Xon/Xoff or none).
  75.  
  76. - his DNS number (Domain Name Server). It's a computer which be asked by 
  77. the Atari to convert HTTP (http://www.eff.net) or FTP (ftp.cnam.fr) 
  78. adresses in IP number.
  79.  
  80. - his domain. For exemple, the Compuserve Domain is compuserve.com
  81.  
  82. - your login (don't smile...)
  83.  
  84. - your password (who said "security" ?)
  85.  
  86. - his newsgroups server (or UseNet server)
  87.  
  88. - his e-mail server
  89.  
  90. - his netmask. This number tells which parts of the IP address can change 
  91. from a connection to another. a 255 means it can change, as a 0 means it 
  92. can't (the compuserve netmask is 255.255.255.0).
  93.  
  94. Installation
  95. --------------
  96.  
  97. 1. Before begining, you may keep in a safe place a copy of all stuff 
  98. you'll install, in case of crashes.
  99.  
  100. 2. Put HS Modem in your AUTO folder, so you'll have a correct serial 
  101. port. Care that DRVIN.PRG must be loaded before the appropriate driver ! 
  102. Set up your driver with SETTER.TTP. Here are the parameters I gave to the 
  103. SCC driver with my Falcon :
  104.  
  105. M2TT :    U
  106. M1EMU :    U
  107. LANBIT :    N
  108. LANEXT :    N
  109. LAN_S2 :    U
  110. DTRM2 :    Y
  111. DTRS2 :    N
  112. M2DRI :    N
  113. S2DRI :    N
  114. RBLM2 :    2048
  115. TBLM2 :    256
  116. RBLS2 :    256
  117. TBLS2 :    256
  118.  
  119. Note : I have put 2048 bytes for the reception buffer of the modem2 port. 
  120. Like that, my modem can still receive data during about 1 second, even 
  121. during disk access : this improve a little bit the transfert. So adapte 
  122. this buffer size to your configuration.
  123.  
  124. 3. Check that you don't have a MINT.CNF file at the root of your boot 
  125. partition, nor MINT or MULTITOS folder. If yes, move or rename them.
  126.  
  127. 4. Unpack the file BOOT.TOS at the root of your boot partition, and then 
  128. launch it. It's an auto-extractible archive. Check that MINTNP.PRG will 
  129. be the last launched program of the AUTO folder. The MINT folder contains 
  130. the configuration file MINT.CNF, the PPP drivers of the net-101b.tgz kit 
  131. (ie SLIP.XIF and SOCKDEV.XDD)
  132. (Note : XIF = eXtended InterFace, XDD = eXtended Device Driver).
  133. It also contains OLDTOS.PRG which will launch the TOS of your Atari after 
  134. loaded MiNT. You'll find also at the same root the NOHOG.ACC accessory. 
  135. It also came from net-101b.tgz. It is essential to use a one-task-at-time 
  136. TOS, to forbid MiNT conflicts with MintNet.
  137.  
  138. 5. Choose a 1.5 Mb free partition. It could be your boot drive.
  139. Here is the point : we will create a folder that will be considerated by 
  140. MiNT as a Minix partition. Uncompress the MINTNET folder of the archive. 
  141. Here is his architecture :
  142.  
  143. MINTNET --|-- BIN         <- for binaries
  144.           |
  145.           |-- ETC         <- informations to change
  146.           |
  147.           |-- HOME
  148.           |
  149.           |-- TMP         <- the temporaries files of applications
  150.           |                   will be here
  151.           | 
  152.           |
  153.           |-- USR -- UCB  <- empty for now
  154.           |
  155.           |-- VAR --|-- ADM  <- error messages
  156.                     |
  157.                     |-- LOG  <- same thing
  158.  
  159.  
  160. I want to notice here a bad thing. In order to be executed from the 
  161. desktop, a program must have a TTP ( or PRG, GTP...). So I renamed SH 
  162. (it's a shell) in SH.TTP. But after this, other programs as pppd don't 
  163. find it. So I decided to put two copies of this shell, SH and SH.TTP. A 
  164. better idea is welcome...
  165.  
  166. 6. Choose a partition, with a big amount of free space on it !
  167. CAB will put here all informations from Internet (HTML pages, images, 
  168. sounds, movies...). If you not reserve enough space, Cab will delete old 
  169. files to put the newer ones. Create a WWWCACHE folder in the chosen 
  170. drive.
  171.  
  172. 7. Install Cab. Choose the correct RSC file in CAB\RSC folder (default is 
  173. english), and rename it CAB.RSC in the same folder than CAB.PRG. You can 
  174. destroy the RSC folder after that. It will free space ! Open Cab. In 
  175. Option menu, choose Path and full it with the WWWCACHE directory you've 
  176. just created. Copy the CAB.OVL file of the kit into the CAB\MODULES 
  177. folder.
  178.  
  179. 8. With a text editor (vi, everest...), modify the \MINT\MINT.CNF file. 
  180. Search the following lines :
  181. sln d:\mintnet\bin u:\bin
  182. sln d:\mintnet\etc u:\etc
  183. sln d:\mintnet\usr u:\usr
  184. sln d:\mintnet\var u:\var
  185. sln d:\mintnet\tmp u:\tmp
  186.  
  187. replace all "d:" by the letter of the drive where you put MINTNET. Now, 
  188. you can access (when MiNT is active, for sure...) your "Mint partition" 
  189. by the unified drive "U:". Instead of searching a program in 
  190. d:\mintnet\bin, you may search in u:\bin.
  191.  
  192. 9. Modify the \MINTNET\ETC\CHATFILE file.
  193. For this, you have to write a connection script which depends of your 
  194. provider. I'll take the example of Compuserve, as they are my provider...
  195. I used Storm (but you can use connect 2.46 or any communication soft 
  196. instead).The following is the way a connection occurs (-> indicates what 
  197. I typed, # is a comment) :
  198.  
  199. *********************************************************
  200. ->ATM(return)        # to shut down the modem sound
  201. OK
  202. ->ATD36064444(return)    # National french TRANSPAC number
  203. CONNECT 57600
  204. TRANSPAC 240901019
  205. ->196282595(return)    # TRANSPAC number of Compuserve
  206. COM
  207. Host Name:
  208. ->CIS(return)        # Compuserve Information Service
  209. User ID:
  210. ->MY_COMPUSERVE_NUMBER/GO:PPPCONNECT\MY_PASSWORD(return)
  211. PPP Connection
  212. One moment please...
  213. ******************************************************************
  214. Following a PPP request, constitued by esoteric signs. Your 
  215. \MINTNET\ETC\CHATFILE will exactly describe what the \BIN\CHAT program 
  216. will send to the modem, and what response is expected from your provider. 
  217. For this goal, I picked out some keywords that have to be expected by 
  218. CHAT for each action I do. Be careful, you'd better choose short 
  219. keywords, to be sure they'll be recognized. As example, I choose PAC 
  220. instead of TRANSPAC, one more reason is that firts letters are often 
  221. skipped.
  222.  
  223. Action I do                                Keywords I wait
  224. ATM                                    OK
  225. ATD36064444                                CONNECT
  226.                                     PAC
  227. 196282595                                ame:
  228. CIS                                    ID:
  229. MY_COMPUSERVE_NUMBER/GO:PPPCONNECT\MY_PASSWORD
  230.  
  231. Now You just have to copy these datas in the \MINTNET\ETC\CHATFILE file. 
  232. Let's begin by define the messages which indicate that the connection 
  233. failed (compulse your modem manual...)
  234.  
  235. ******************************************************
  236. ABORT 'NO DIALTONE' 
  237. ABORT 'NO CARRIER' 
  238. ABORT BUSY 
  239. ABORT WAIT 
  240. ABORT DELAYED 
  241. ******************************************************
  242.  
  243. Now I can type the commands :
  244. ******************************************************
  245. "" 
  246. atm OK 
  247. atdt36064444 CONNECT 
  248. "" PAC 
  249. 196282595 Name: 
  250. CIS ID: 
  251. MY_COMPUSERVE_NUMBER/GO:PPPCONNECT\\MY_PASSWORD
  252. ******************************************************
  253.  
  254. Notes :
  255. a) the "" indicate no response or no request.
  256. b) CHAT accepts CR, but want a space character between each command.
  257. So do'nt forget it - I put it at the end of each line -.
  258. c) \\ are not mistaken.
  259.  
  260. 10. Modify your \MINTNET\ETC\CONNECT.SCR
  261. As I use a falcon, I use the /dev/modem2 port. It can be different on 
  262. another computer. When MiNT is running, have a look at the u:\dev\ 
  263. folder. All ports are listed.
  264.  
  265. 11. Modify the \MINTNET\ETC\RESOLV.CON
  266. Replace compuserve.com with your provider's domain name.
  267. Replace Compuserve's nameserver (149.174.211.5) with your provider's one. 
  268. You may put several ones.
  269.  
  270. 12. Reboot. Open a window on U:\BIN\. Install the application SH.TTP and 
  271. give it 'SCR' as document type. Change the path of this window to 
  272. U:\CAB\. Open a new window on U:\ETC\SCR\.
  273.  
  274. 13. Load the utilitary MODEM.CPX. Paramit it in following informations of 
  275. your Internet Acces Provider (IAP). You must know that HS MODEM convert 
  276. 110 bps to 38400 and 134 to 57600. Save informations of the CPX. Save the 
  277. desk.
  278.  
  279. How To Use
  280. ----------------
  281. Launch the CONNECT.SCR connection script by double-clicking on it. This 
  282. script will launch pppd which launch chat. Some informations will be 
  283. displayed to tell you how the connection evoluate (later, you'll change 
  284. the /etc/syslog.conf to correct this). After a while, your modem's leds 
  285. will stop lighting : you are connected !
  286.  
  287. Now you can launch CAB... Have a nice netsurfing !
  288.  
  289. Warning : Wait you are well-connected before run CAB. If not, the overlay 
  290. won't be active, and so you couldn't access Internet.
  291.  
  292. On a lot of Web page, it is possible to send mail to the author. Don't 
  293. try for this time : Cab_for_MiNTNet 1.77 don't allow this option :-(
  294.  
  295. To end the connection, launch the DCNNCT.SCR. This will interrupt the PPP 
  296. connection, and hang up the modem. I recommand always that you finish by 
  297. this way. Like that your IAP will know that you are not still connected !
  298.  
  299. Before to turn off your Atari, launch EXIT.SCR. It is more clean.
  300.  
  301. I personnaly use 2 configurations :
  302. - one for the connection to Internet, with HS Modem and MiNT. I launch it 
  303. in monochrome for a maximum of speed and memory.
  304. - one for consulting pages downloaded, without MiNT nor HS Modem, but 
  305. with SpeedoGDOS, in 256 colors.
  306.  
  307. With NVDI, displays are so quick that you can connect you directly in 256 
  308. colors without an important loss of time.
  309.  
  310. If it works
  311. -----------
  312. You can modify the kit to remove message at the connection. Edit the file 
  313. \ETC\CONNECT. Remove -d parameter in the call to pppd and -v to the two 
  314. calls to chat.
  315.  
  316. If it doesn't work
  317. ------------------
  318. Begin with disconnect, reboot, and relaunch connection : sometime it 
  319. doesn't work at the first time !
  320.  
  321. If the connection seems to be well happend and that, nevertheless, Cab 
  322. can't load page that you ask, try to see a little thing : when you ask it 
  323. a new address HTTP, Cab must interroge your IAP for decoding this 
  324. address. You should then see the send LED, and after the receive LED of 
  325. your modem flash. If not, then Cab don't even know that you are 
  326. connected.
  327.  
  328. You'll find in the U:\BIN\ folder some utilitaries which allow you to see 
  329. the MiNTNet configuration. Begin by launch the shell TCSH.TTP without 
  330. parameters. The screen is cleared, with a prompt /home->
  331. You can then launch programs by tipping thier name and RETURN. Try to 
  332. launch route, ifconfig and netstat. Here is what I get when I'm connected 
  333. :
  334.  
  335. /etc-> route
  336. Destination         Gateway             Flags   Ref      Use Metric Iface
  337. default             206.175.66.56       UGD       1       21      0 ppp0  
  338. 206.175.66.56       *                   UHD       1        0      0 ppp0  
  339. 127.0.0.0           *                   U         1        0      0 lo0   
  340. 127.0.0.1           *                   UH        1        0      0 lo0   
  341. 199.174.233.26      *                   UH        1       11      0 lo0   
  342.  
  343. Note :
  344. 199.174.233.26 is the number my IAP give to my computer.
  345. 206.175.66.56 is the number of my IAP computer.
  346. The first line indicate that if I want to connect me to another computer, 
  347. I must pass throught my provider.
  348.  
  349. /etc-> ifconfig
  350. lo0:    flags=0x4b<UP,BROADCAST,LOOPBACK,RUNNING>
  351.     inet 127.0.0.1 netmask 255.0.0.0 broadcast 127.255.255.255 
  352.     metric 0 mtu 16384
  353.     in-packets  0 in-errors  0 collisions 0
  354.     out-packets 0 out-errors 0
  355. ppp0:    flags=0x51<UP,POINTOPOINT,RUNNING>
  356.     link-level-flags=0x3b
  357.     inet 199.174.233.26 netmask 255.255.255.0 dstaddr 206.175.66.56 
  358.     metric 0 mtu 1500
  359.     in-packets  16 in-errors  3 collisions 0
  360.     out-packets 22 out-errors 0
  361.  
  362. /etc-> netstat
  363. Active TCP connections
  364. Proto  Recv-Q Send-Q Local-Address        Foreign-Address      State
  365. Active UDP connections
  366. Proto  Recv-Q Send-Q Local-Address        Foreign-Address      State
  367. UDP         0      0 *:*                  *:*                  CLOSED
  368.  
  369. For leaving TCSH, type 'exit'.
  370.  
  371. You can also ask to SYSLOGD to store messages which are send by PPPD and 
  372. CHAT in the file \VAR\ADM\MESSAGES. Begin in editing the file 
  373. \ETC\SYSLOG.CON. Add a line '-d ' (with a space !), and the keyword '-v' 
  374. in the two calls to CHAT. Try a new connection. And read the file 
  375. \VAR\ADM\MESSAGES : it contains the description of your connection, step 
  376. by step, with PPP negociation and so on. Check the size of this file : it 
  377. grownth quick. When it is too big, reboot without MiNT (like that this 
  378. file will not be protected), and replace it by an empty file.
  379.  
  380. Contribution
  381. ------------
  382. As I said, I spent lot of time in understanding how that works. I should 
  383. consacrate this time in preparing my maths master. So you may send me a 
  384. ridiculous $10 fee to support me ! If I'm overflowed by questions, I'll 
  385. response in priority to the "registered" guys (which I think it's normal, 
  386. don't you ?).
  387.  
  388. At the end, don't forget to register CAB too. Alexander Clauss has to be 
  389. congratulated for his marvellous soft.
  390.  
  391. Useful address
  392. --------------
  393. If you want to know more about MiNT (I read this page at the end of my 
  394. work... arghh...) :
  395. http://www.gti.net/azog/mint-docs.html
  396.  
  397. Cab author :
  398. Alexander Clauss
  399. Stresemannstr. 44
  400. D-64297 Darmstadt
  401. Germany
  402. Email : aclauss@rbg.informatik.th-darmstadt.de
  403.  
  404. MiNTNet author :
  405. Kay Roemer
  406. Email : roemer@vsb.informatik.uni-frankfurt.de
  407.  
  408. HS modem author :
  409. Harun Scheutzow
  410. Dresdener Stra₧e 83
  411. D-10179 Berlin, Germany
  412. Mausnet: Harun Scheutzow @B
  413. Email : Harun_Scheutzow@b.maus.de
  414. (Email < 16 kbyte only)
  415.  
  416. Cab_for_MiNTNet author :
  417. Andrew Vesperman
  418. Email : dancer@brisnet.org.au
  419.  
  420. Me :
  421. Abel PHILIPPE
  422. 16, rue St Ferdinand
  423. 75017 PARIS
  424. Email : p-abel@imaginet.fr
  425.  
  426. As usual, if you you have any comments to tell or any correction to give, 
  427. please contact me. I'll take them in consideration in further versions
  428.  
  429. Oh ! I was forgetting : thanks to Sebastien Ducleroir for the 
  430. translation.